home *** CD-ROM | disk | FTP | other *** search
/ Assassins - Ultimate CD Games Collection 4 / Assassins 4 (1999)(Weird Science).iso / docs / arcade / sovereign_slots.doc < prev    next >
Text File  |  1992-09-02  |  9KB  |  245 lines
  1.  Customisable fruit machine. Babylon 5/Star Trek. 64 cols
  2.  
  3.                            Sovereign Slots
  4.                      Copyright by S.Goodwin 1997
  5.  
  6.  Short: A customisable fruit machine program, with 4 machines.
  7.  
  8.                            --- The keys ---
  9.  
  10.         Start reels                     Space, Return
  11.         Stop reels                      Space, both mouse keys
  12.         Exit machine                    Escape, ' (tilde key)
  13.         Show winning combinations       Help
  14.  
  15.                            --- Features ---
  16.  
  17.         4 different 'themed' machines (all in 64 colour EHB mode)
  18.         Skill shot
  19.         Up to 6 nudges
  20.         Nudge up/down toggle
  21.         Holds
  22.         Four reels
  23.         Customisable sound, graphics, and game structure
  24.  
  25.                           -- Information ---
  26.  
  27.    I wrote this program as a  response  to the PC program '101 Fruits'
  28.  where one basic engine ran 101  different fruit machines. I decided to
  29.  write my own. This one allows you to customise:
  30.  
  31.  * The main screen graphics
  32.  * The reel graphics (including their ordering)
  33.  * The winning lines
  34.  * The win amounts
  35.  * The sounds
  36.  * The skill text
  37.  * The starting bank
  38.  * Cost of each play
  39.  
  40.    I have included four variations to  show you the basics (along with
  41.  the template files). If you create a new slot machine, then send it to
  42.  me (or upload to the Aminet) so we can top the PC's 101 slots!
  43.  
  44.                           --- Operation ---
  45.  
  46.    On program startup, 'Sovereign  Slots'  looks  for  all the '.game'
  47.  files in the current directory. It then  displays each name in its own
  48.  button. Click on this button to play that game.
  49.  
  50.    When the slot machine has  loaded,  the  'Start' button will flash.
  51.  This allows you to:
  52.  
  53.  1) Spin the reels (by  clicking  on  the  button, or pressing space or
  54.  return)
  55.  2) Get help on which  reel  combinations  score the most points. Press
  56.  the 'Help', or 'H', key for this feature.
  57.  3) Exit the machine (pressing Escape, or tilde ')
  58.  
  59.    There are two totals at the top of  the screen. The one on the left
  60.  is the current bank  total,  the  one  on  the  right  is your current
  61.  wealth.
  62.  
  63.    Once the reels have started to  spin  you can bring them quickly to
  64.  halt by pressing:
  65.  
  66.  1) The space key
  67.  2) Both mouse buttons
  68.  
  69.    If you've won, the bank will show  the  amount won, and then add it
  70.  to your account.  Most  features  are  self  explanatory (the 'holds'
  71.  flash when you hold, the 'nudge' buttons light up when you may nudge -
  72.  check the nudge direction first). If  you  get a skill shot (sometimes
  73.  occurs after a win), you should press 'space' when the light is on the
  74.  rightmost letter in the title, at  the  top of the screen. Each letter
  75.  lit increases your win. The left hand indicator shows this.
  76.  
  77.                     --- Creating you own games ---
  78.  
  79.  In the 'Template' directory  is  a  sample  game.  It comprises of the
  80.  following files:
  81.  
  82.  template.game   ASCII description of the game itself
  83.  template.gfx    The reels, buttons and skill shot title
  84.  template.slot   The main, backdrop image
  85.  template.snd    An AMOS sample bank for the sounds. This is optional.
  86.                 Sovereign slots will load 'Standard.snd' if this can
  87.                 not be found.
  88.  
  89.    Now, if the files are not obvious, a short explanation of:
  90.  
  91.  template.game
  92.    This text file consists of three types of line:
  93.  
  94.  1) Comments. Denoted with ';'
  95.  2) Headings. Shown with '#'
  96.  3) Data. Alpha-numeric characters in the lines following the '#'
  97.  
  98.    If you are unsure of what any  entry is, leave it out. The software
  99.  will supply defaults to make your job easier.
  100.  
  101.    The valid headings (and their associated data) is:
  102.  
  103.  #line   Describes what is on each reel, in order. The first line after
  104.         the heading describes the first (left-most) reel, and so on.
  105.         The letters 'a'-'g' must be used.
  106.  
  107.  #win    A description of each winning line, using the same notation in
  108.         the '#line' heading with a '-' used as a wildcard.
  109.  
  110.  #credits The initial sum in the players bank
  111.  
  112.  #cost   The number of credits deducted each turn.
  113.  
  114.  #rpos   Position of the reel overlay. DO NOT CHANGE THIS DATA.
  115.  
  116.  #skill  Describes the location of the skill shot images. The first two
  117.         are the Y and X (in that order!) of the top left of the image.
  118.         The others are X positions of the start of each letter in the
  119.         word. You *MUST* also include the X position of the *end* of
  120.         the last letter. This is usually 319.
  121.  
  122.  #nudge  Holds the X,Y co-ordinates of each 'nudge number'. Each line
  123.         is stored 'x,y', without spaces. The default positions are:
  124.         5,170   25,147  5,124   25,101  5,78    25,55
  125.  
  126.  #coords The co-ordinates of the totals. In order, each line details:
  127.         X co-ord of the players' total
  128.         Y co-ord of the players' total
  129.         1 if the X co-ord represents the left edge of the numbers
  130.         Number of padding characters. 3 means that a minimum of
  131.                 three digits are shown.
  132.         X co-ord of the win bank
  133.         Y co-ord of the win bank
  134.         1 if the X co-ord represents the left edge of the numbers
  135.         Number of padding characters. 3 means that a minimum of
  136.                 three digits are shown.
  137.  
  138.  #test   Used only when testing the machine. This gives the player the
  139.         ability to get all the features occurring on successive plays.
  140.         It lets you see which graphics are mis-aligned.
  141.  
  142.  template.gfx
  143.    Each image in the reel is 40x25.
  144.    Each number (top-right) is 25x25.
  145.    Each button is 40x25.
  146.    The skill shot title is 160x30.
  147.    Must be the same palette as 'template.slot'
  148.  
  149.  template.slot
  150.    The area for the reels *MUST* be  colour  zero. If you reels do not
  151.  appear - this is most probably  the  reason.  This is done so that any
  152.  non-zero pixels will  be  overlayed  once  the  reels  are drawn. This
  153.  permits 'Win Line', and other text to be overwritten.
  154.  
  155.    The palette must have a light colour  as index 2 (pref. white), and
  156.  a dark colour as index 1 (pref.  black). Most art packages will assist
  157.  you to remap to this  spec.  if  necessary.  This allows the player to
  158.  read the numbers at the top of the screen.
  159.  
  160.  template.snd
  161.    Each sample must be in its  proper  place  or the slot machine will
  162.  sound very wierd. The samples order is:
  163.  
  164.   1 - Waiting for start
  165.   2 - Reel #1, nudge/hold sound
  166.   3 - Reel #2, nudge/hold sound
  167.   4 - Reel #3, nudge/hold sound
  168.   5 - Reel #4, nudge/hold sound
  169.   6 - Reels spinning. This will be looped internally.
  170.   7 - 'Clunk', for when a reel stops spinning
  171.   8 - Skill shot background sound. This will be looped internally.
  172.   9 - Skill shot, key pressed sound
  173.  10 - Skill shot win! Rising sound on replay
  174.  11 - Skill shot win! Sinking sound on replay
  175.  12 - Beep when a nudge is added. Also used when added scores to bank.
  176.  13 - Skill shot, failure noise.
  177.  
  178.                           --- Afterword ---
  179.  
  180.  This is a very short program. There's a lot I would like to do:
  181.  
  182.  Control logic embedded inside the file.
  183.  Use transparency to make the 'nudge numbers' easier to create.
  184.  Independent positioning of the reels, and testing everything with
  185.  bullet-proof data.
  186.  Add another 97 slot machines! A big job...but with *your* help....
  187.  
  188.                           --- Dedication ---
  189.  
  190.  To Grandma. Who died on the  day  I  finished the code, and was buried
  191.  the day after I finished the graphics.
  192.  
  193.                          -- The Final Word --
  194.  
  195.  This program is shareware, you can  use  it for 30 years (yes, years!)
  196.  before paying for it. If,  however,  you  want the source (in AWE-AMOS
  197.  and ASCII) then send me £5, and  I'll  return  you a disc with all the
  198.  source and the latest version of Sovereign Slots.
  199.  
  200.  Now,
  201.  
  202.  Q. Where do I send my money?
  203.  A. Steven Goodwin
  204.     105 St. Johns Road
  205.     Clacton-on-Sea
  206.     Essex CO16 8DB
  207.  
  208.  Q. What do I say?
  209.  A. Try printing this off....
  210.     (or copying the relevant bits if you're without a printer)
  211.  
  212.  o/_________________________ CUT HERE ________________________________
  213.  O\
  214.  
  215.  Your Name:_______________
  216.  Address  :_______________
  217.           _______________
  218.           _______________
  219.           _______________
  220.  
  221.  Hi Mr. Steven Goodwin,
  222.  
  223.    I would like to register my copy of Sovereign Slots because
  224.  
  225.  a) I have been using it for the shareware limit of 30 years!
  226.  b) I want to know how you auto-configure for the '.game' files!
  227.  c) I'd like to see how the reel movements are so damn cool!
  228.  d) I want to add my own logic to make it win more often!
  229.  e) I have a tremendous guilt complex!
  230.  f) All of the above                         (circle as appropriate)
  231.  
  232.    I enclose a cheque/postal order for £5 (which includes P&P) because
  233.  I'm a kind hearted  soul  who  cares  about  the  people  you make my
  234.  software.
  235.  
  236.    Thanks very much,
  237.  
  238.        Name ________________ (not completely necessary, but ties up the
  239.                               letter nicely)
  240.  
  241.  o/_________________________ CUT HERE ________________________________
  242.  O\
  243.  
  244.  That's all folks!!!! See you on the next release...
  245.